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Manual for ZX-Tape 


Interface V1.02 


ZX-Tape is a Bluetooth interface for connecting ZX Spectrum with PC for loading and saving programs. If 
you use any Z80 compiler on your PC, the ZX-Tape interface can download your hex/bin file directly into 
spectrum’s memory and execute the code automatically. 
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1. Introduction 


Dear customers, please let me introduce you to the ZX-Tape interface device. It was developed during 
COVID-19 lockdown 2020 for my kids to keep them entertained by learning a basic programming 
language. Even though the ZX spectrum in present days is more associated with an older generation, 
there will always be something magical in the simplicity of the design and games written for this 
machine. When architecture of modern computers grows in complexity, the way to understand 
computers and how they work for young enthusiasts becomes objectively more complicated. To teach 
my kids, | had to step back and recover my old ZX Spectrum from the attic. This machine might be old, 
but in spite of its simple architecture it maintains the same main principle of modern computers. Thus it 
will always be a good educational tool which even kids can understand. 


Why did | decide to design the ZX-Tape interface device? The weakest point of the original ZX-Spectrum 
in modern days is how the programs are loaded and saved onto the tape. Anyone who decides to spend 
time writing programs for ZX-Spectrum, expects fast and reliable Load / Save commands. Similar 
products already exist on the market, capable of saving and loading programs directly from SD Card, so 
why create a new one with Bluetooth? 

As the purpose of this device is mainly educational, the programmers should be able to write and test 
programs written in assembler language. Direct connection to the PC allows this to happen. The PC can 
run a programming tool called Zilog Developer Studio for writing assembler code. The ZXTape 
application will automatically load the program into ZX Spectrum after successful compilation. The result 
can be seen almost immediately (see DBG mode in this manual for further details). This advantage can’t 
be achieved with other interfaces on the market. In addition, with connection to the PC, you can play 
games from the internet straight away after download. There is no need to learn new commands as the 
Load / Save works exactly as you would use an old cassette recorder. Furthermore, Bluetooth serial 
communication hardware can also extend your own programs. 


1.1 Key features 
e The basic program of ZX Spectrum in ROM operates exactly the same way as per original. No 
additional or special commands are introduced. 
e Loading and saving programs in TAP file format over the Bluetooth to your windows PC running 
a ZXTape application. Supported OS versions: Windows XP’, Windows 7, 8 and 10. 
e 2x Joystick interfaces configured as: Sinclair1 and Sinclair2 or Kempston and Sinclair2. 
e Use of standard removable HC-05 Bluetooth module in RS232 mode with baud rate of 115200. 
e Description of registers, so the Bluetooth communication can be used in custom programs. 
e DBG mode: Write assembler under Zilog Developer Studio with a fast upload into ZX-Spectrum 
(Like Matthew Smith during the development of Manic Miner). 
e Supported models: ZX Spectrum 16kB/48kB 
[1] Note: If the Bluetooth stack installed on Windows XP is from another company than Microsoft, the application cannot detect the presence 
of ZXTape Bluetooth device. If that is the case, you have to close and re-open ZXTape application every time you disconnect ZX spectrum from 


the power. Remember, ZX-Tape interface includes RESET button, so normally there is no need to disconnect ZX spectrum from power in order 
to reset it. 
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2. Installation and configuration 


Before you can use the ZX-Tape interface, it has to be connected via Bluetooth with your windows PC. 
The Bluetooth device is a separate module HC-05 which can be detached from the ZX-Tape interface. It 
provides serial port connection between ZX-Spectrum and your PC. The HC-05 module comes 
pre-configured to: 115200 baud rate, 8 data bits, 1 stop bit and no parity. Device name is set to: ZXTape. 
These parameters cannot be changed in order to ensure the device operates with ZXTape application 


correctly. 


Please, follow the instructions below to connect the ZX-Tape interface with your PC. The pictures shown 
are taken from Windows 8 and can differ from other versions of windows operating systems. There are 
several ways to set up connection with a Bluetooth device. Here is one of them: 


2.1 Connecting Bluetooth device: 
a) Insert ZX-Tape interface hardware into you ZX Spectrum and power it on. 
b) On the bottom bar of the windows PC, click the small arrow on the right hand side to reveal 


small icons: 


Customise... 





c) Click the Bluetooth icon and select Show Bluetooth devices. After the ZX Spectrum is 
powered on, an unknown device icon will appear on the screen, this will later update to 


ZXTape: 


‘@) mGnr- ale me (sees Manage Bluetooth devices Manage Bluetooth devices Manage Bluetooth devices 


Your PC is searching for and can be discovered by Bluetooth devices Your PC is searching for and can be discovered by Bluetooth devices 


Your PC is searching for and can be discovered by Bluetooth devices 
. . . *e 


Lock screen 


Avantree Roxa Avantree Roxa Avantree Roxa 
Display Paired Paired Paired 
aan MAXTEK AUDIO MAXTEK AUDIO oes AUDIO 
Paired Paired Paire 
Devices Unknown ZxXTape 
Ready to pair Ready to pair 


Mouse and touchpad 
Typing 
Comers and edges 


Power and sleep 


AutoPlay 


Disk space 


PC info 
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d) Click the Pair button on ZXTape device and enter code: 1234 when prompted. If the pairing 
process was successful, the status will change to Paired: 


© mGer- ale me (=. aos Manage Bluetooth devices Manage Bluetooth devices 
Your PC is searching for and can be discovered by Bluetooth devices. Your PC is searching for and can be discovered by Bluetooth devices. 
Kore @etoo) > ee 
oo) Avantree Roxa ia Avantree Roxa 
Display - Paired ‘ Paired 
MAXTEK AUDIO MAXTEK AUDIO 
S(T) Core) dy) Danreid Paired 
Devices ZXTape Mey 2XTape 
=o Ready to pair Paired 





i feltnvoe-lpemceleleal este) 


Typing 

Corners and edges 
Power and steep Enter the passcode for your device 
AutoPlay 


You might need to enter the same passcode into the device. 


Disk space 


oy 


PC info 





Once the Bluetooth device is paired, there is no need to pair it again. When the ZX-Tape interface is 
powered and within good radio reception, then the ZXTape icon will appear in the Bluetooth device 
window with a status: Connected. The distance for good reception varies between 5 and 10 meters. It 
also depends on obstacles in-between the peers, for example a wall can reduce Bluetooth reception. 


2.2 COM port verification for ZXTape application: 
When the Bluetooth is paired, you should see in the Device Manager under Ports (COM & LPT) two new 


com ports: 


Fil “a eee ne Although two com ports appear, only one of them is used as a serial 
2°95 | 0 


2 SPC | line. Our example here shows COM3 and COM4. 


& Audio inputs and outputs 
8 Bluetooth 
?>= Computer 


ca Disk drives You could try out both serial ports in the ZXTape application to see 


&, Display adapters 
reas: ca which one will work. Alternatively, continue reading this section to 
¥ IEEE 1394 host controllers 


| FF Imaging devices explicitly identify the correct one. Open the Control Panel using 


& Jungo 
» & Keyboards 2g 7 7 | 
a 4+X and then click on Devices and Printers: 
» B&) Monitors 
» RY Network adapte 
L Orts (COM & LPT) 
Fy Standard Serial over Bluetooth link (COM3) 
Fr Standard Serial over Bluetooth link (COM4) 
air Raiat queues 
> i Printers 
» BB Processors 
@& SD host adapters 
(2! Sensors 





| Software devices 
% Sound, video and game controllers 


. €= Starane controllers 
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© ~ % > Control Panel > All Control Panel Items 


Adjust your computer's settings 


od Action Center 

tg AutoPlay 

EA Colour Management 
Default Programs 
Display 

\@ File History 

dA Fonts 

Intel® HD Graphics 

ao Language 

# Mouse 

a Personalisation 

hs Programs and Features 
(3 RemoteApp and Desktop Connections 
& Storage Spaces 

Taskbar and Navigation 
@ Wacom Tablet Properties 
&} Windows Update 


Then scroll down to unspecified devices 
and double click on ZXTape device: 


When the ZXTape properties window is 
shown, click on Hardware tab to find 
out the COM port number for the 
Bluetooth. In our example it is COM3: 





General Hardware | Services | Bluetooth | 


3 


Device Functions: 








Name Type 


' Standard Serial over Bluetooth link (COM3) Ports (COM ... 
8] ZXTape Bluetooth 











Device Function Summary 
Manufacturer: Microsoft 


Location: on Bluetooth Device (RFCOMM Protocol TDI} 
Device status: This device is working properly. 
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@ Add features to Windows 8.1 
Shes BitLocker Drive Encryption 
@ Credential Manager 

aa Device Manager 

© Ease of Access Center 

Flash Player (32-bit) 

2@ HomeGroup 

Internet Options 

Location Settings 

“ Network and Sharing Center 
UE] Phone and Modem 

& Recovery 

ay Sound 

3) Sync Center 
Troubleshooting 

ar Windows Defender 

B Work Folders 
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Search Control Panel 


v © 


View by: Smallicons ¥ 


Q Administrative Tools 
= Boot Camp 


~ Date and Time 


®B Family 


= Keyboard 

&® Mail (32-bit) 

© Notification Area Icons 
> Power Options 

& Region 

& Speech Recognition 
1 System 

oy User Accounts 

@ Windows Firewall 





© ~ % && > Control Panel » All Control Panel items » Devices and Printers v @ 


Add a device 


Avantree Roxa 


Add a printer 


LG Ultra HD 


4 Multimedia Devices (1) 


oO 


[TV]Samsung 
LED46 


4 Printers (6) 


Adobe PDF 


4 Unspecified (4) 


IEEE-1284 
Controller 


IR Receiver 


ZxTape 


Remove device 


ON ae om 


USB Input Device 


Logitech HD Pro MAXTEK AUDIO SIPCO2 


Webcam C920 


2 


Samsung C410 


Microsoft XPS 
Document Writer 


Samsung C460 


Series 
(192.168.1.75) 


Unknown USB 
Device (Set 
Address Failed) 


Model: Bluetooth Peripheral Device 
Category: Unknown 





"| Devices and Printers 
Ee Folder Op) View and manage devices, printers 
F and print jobs 
& Indexing Gpererr 


Send To 
Series OneNote 2010 


Search Devices and Printers 


2 
Sry @ 


a 


USB Receiver 
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2.3 Installation of ZXTape application 


Registered in Scotland No. 494361 


info@sitronik.co.uk 


SrrrRonik 


Download compressed installation files from the following web site: 


www.sitronik.co.uk/ZXTape/software.zip and extract software.zip file. After the extraction you should 


see 2 files: 


Setup ZX Tape.msi 
setup.exe 


Follow next steps to complete installation of ZXTape application. 


1. Double click on setup.exe file and then click 
NEXT > button when Setup Wizard window 
appears. 


Welcome to the 7X Tape Setup Wizard 





The installer will guide you through the steps required to install 2¢ Tape on your computer. 


WARNING: This computer program is protected by copyright law and international treaties. 
Unauthorized duplication or distribution of this program, or any portion of it, may result in severe civil 
of criminal penalties, and will be prosecuted to the maximum extent possible under the law. 





Cancel 


Confirm Installation 


The installer is ready to install 24 Tape on your computer. 


Click "Next" to start the installation. 








Cancel 
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2. Choose a folder where you wish to install the 
application and which users can access it. 
Then Click NEXT > button. 


Select Installation Folder 





The installer will install 2¢ Tape to the following folder. 


To install in this folder, click "Next''. To install to a different folder, enter it below or click "Browse". 


Folder: 


[C:\Program Files (x86)\SiITRONIKNZX Tape’, Browse... 


Disk Cost... 


Install ZX Tape for yourself, or for anyone who uses this computer: 


(@) Everyone 


©) Just me 





Cancel 





4. Click Close to exit. The ZXTape application is 
now installed. 


Installation Complete 


2% Tape has been successfully installed. 


Click "Close" to exit. 


Please use Windows Update to check for any critical updates to the NET Framework. 





Cancel < Back Close 
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3. ZXTape application 


File Settings Tools Abou Close the application button 


Menu 
State of communication 


Close the menu button 


Mca ah 1 


r Hil 


Minimize the application button 





The ZXTape application is a windows software in the shape of cassette tape. Its main purpose is to 
simulate a tape recorder. It can be also used for loading binary or hex files produced by assembler or C 
compiler on your PC directly into memory of ZX spectrum for further debugging purposes. The hard 
drive of your computer will serve as storage for your programs. ZXTape application supports files in TAP 
format only. This format is the closest to that used to store data on the real tape. Most of the programs 
and games you can download from internet websites, like worldofspectrum.org are in this format 
already. In case of TZX format (a more general format which includes other machines from 8bit world) 
you Can use converter from the menu Tools for conversion to TAP file. 

The most important feature of this product is that no new commands are introduced into 
BASIC/Monitor firmware. The aim is to give you something that you are used to. The LOAD and SAVE 
commands will work exactly the same old way. Their routines were overwritten in ROM to work with 
standard serial port RS232 over Bluetooth and few lines of code have been added to support 
downloading assembler directly into memory of ZX Spectrum. This feature can help you easily improve 
your assembler skills too. | hope that this simple hardware will cover all aspects of educational tool. 


3.1.1 Loading and Saving programs 


After correct installation of the ZX-Tape interface you can use LOAD and SAVE commands straight away. 
All spectrum programs will be loaded and saved into the TAP directory you choose in the menu Settings. 


See section 3.2.2. 


= = LOAD “ManicMiner” | 


re ee ee a re ees 


SAVE “MyBasicCode” 
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3.1.2 Tap internal names and file names 


ZX-Tape is fully compatible with your old ZX Spectrum, so when you use the command LOAD 
“ProgramName’, then the parameter “ProgramName” must correspond to the name inside of the data 
file, not to the name of the file. Some programs downloaded from the internet might not have the file 
name identical to internal name of the TAP file. For example you can download the game Bumpy 
(1989)(Loriciels). TAP The filename is called Bumpy (1989)(Loriciels), but its internal name inside of the 
TAP file is “BUMPY”. See picture below: 


File Edit Search Insert Project Wiew— Format Column Macro Scripting Advanced Window Help 
ee Ce ice ee a a esa 7 


Bumpy (1989)(Loriciels).Tap x 


H Eee FU 


1 
oo 427 55 4D Sf 


| 
hs 


3 [| hay, 
I fF! Oo 


Ha] i co 
tai 


Sr to ta oe fa 
i 


For Help, press F1 Pos: 4H, 4, C0 DOS 1252 (ANSI - Latin |} (| No Highlighting * Mod: 28/05/1999 0242 .: 





Pp 


Each TAP file has the internal name of\the program hidden here and you use it with command LOAD or it 
is created with command SAVE. Names are cage sensitive with maximum length of 10 characters. Inside 
of the TAP file are located at position 4 to 13. Shorter names are filled with space character 20h up to 
position 13. 

You don’t have to worry that command LOAD “BUMPY” will not work as the ZXTape application searches 
for internal names. But this inconsistency between file names and internal names can become pretty 
confusing. If you want to keep it right, use utility in menu Tools for renaming files to their internal 
names. See section 3.2.3. Remember that SAVE command will always create a filename identical to the 
internal name. 

lf the program with the name you enter doesn’t exist in your TAP directory, you will get an error 


message window on your ZX Spectrum screen: 


LUnablLe to Find 
fp Ie. 


Mani cHiner 
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3.2.1 Menu: File 

In the old days, when you used the LOAD command without entering the program name: LOAD “”, you 
could load the first program which appeared on your cassette tape. The ZXTape application is always 
expecting the name of the program to be entered or you can set a default TAP file in the File menu to be 
loaded if no program name was specified. This can spare lots of typing when loading you favorite game. 


Select a default TAP file which will be loaded 
File Settings Tools Abou when command: LOAD ““ without file name is 
LOAD """file- executed. 


CAP’ Tape List tap 


DBG Tile: 


Enter name of the HEX or BIN file produced by 
C\Zilog Projects’ Test test hex assembler after compilation. See DBG mode in 


DBG file offset: 32/66 section 5. 


Enter offset in bytes where the HEX or BIN file 
data will be read from. 





When working with assembler in DBG mode, you need to specify the name of the output file after 
compilation. It can be either HEX or BIN file. The ZXTape application continuously checks the time 
stamp of this file and as soon as it is changed, it forces a reset of ZX Spectrum in order to download this 
file. 


3.2.2 Menu: Settings 

In this menu, you must set the key parameters like com port and TAP directory in order to get the 
application to work. Once it is set correctly, the tape wheels on the main window will start turning and 
status shows that ZXTape is Ready... 


Selects COM port number for ZX-Tape Bluetooth. 


File Settings Tools About— See section 2.2 to select correct com port. 

Blue Tooth Com Port: |COM4 Selects folder where you store all TAP files. This 
directory is used when you enter Load or Save 

TAP Files Directory: command with a file name in argument. 

CATAP - 

Play tada on SAVE Auto reset in DBG This option will automatically reset ZX Spectrum 


and start loading HEX or BIN file after it has been 
updated. This only works in DBG mode. 





Plays ta-da song after successful execution of 
SAVE command. 


3.2.0 Menu: Tools 


ZXTape application works only with TAP files. The name of the TAP file is case sensitive and must be 


identical to its internal name of the program. This is the name you enter in SAVE “name” or LOAD 
“name” command between quotes. It is maximum 10 characters long and can be found after the 4" 
byte from the beginning of the file when you open it in binary viewer. For more detailed information 
see: https://faqwiki.zxnet.co.uk/wiki/TAP format. 
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Other formats are not supported. That’s why the ZXTape application is offering a few tools which 
can help you with renaming TAP file names to their internal names as well as convert them from TZX 
format to TAP format. See picture with a description below: 


Selects file for revealing its original TAP name. 


Filé Settings Tools 


Select File to reveal TAP name: __ Revealed name of the original TAP file. 
CAT AP*\Bumpy (1989)(Loriciels! 


Name: "BUMPY™ Rename File 


Rename the TAP file to its original TAP name. 


Convers TZX files into a TAP file format, so it can 
be used in the application. Supports only ZX- 
Spectrum up to 48kB. 

Note: After conversion, you might still use the 
above utility to rename TAP file to its original 
name. 


Convert TZX. to TAP file... 





3.2.4 Menu: About 


2 This window provides information about the 





File Settings Tools software version and short description of use. 


fX- Tape 
V¥1.00 


This software is a simulator of tape recorder over 


the bluetooth for ZX Spectrum. It can also load Help button for opening this manual as a pdf. 


your assembler code for debugging purposes. 


To view all programs in your TAP directory on ZX === St 





Arenal Camelot 
Spectrum, you can use the program TapeList.TAP. ZL, 2¥=.,. =aRhUN 
; ‘ : : AUTOCRAS CRHOPPEr 
When you run this program, ZXTape application will BACKGAMHON CHUCK IE r 
d th all j | fi inside EARIGERS SGEGRRG: nee 
7 p 
generate data with all internal TAP tile names Inside BRIGER cheeme gig Be ein 
your TAP directory in alphabetical order so it canbe FEguoee ee BEE TSCHPE 
. BLOCKHAN DARTS PHANTOMAS1 
displayed on the ZX Spectrum. This can be useful if BLOGGHGUTS GEFLEKRTOR PIPELINE 
Jack DETORN | @-BERTUS 
you can’t remember the name of the program you BOMBARDER Dizzubice faiders 
Bone eoack Ete Te SRTENET® 
i i 0 M1 
wish to run. Just use the cursor keys to navigate to EAwe. Sm Gcoie Pea acre 
Bootyd ELIMINATOR TETRIS 46 
the program you want to run and press ENTER. After BoRER GEEP ESKIHa TUNNEL 
ee ; Bridge FARHER PAC -HAM 
the installation, option LOAD” file, in menu File, has BU-RIL Fo& F Loader 
BUMP FOOTBALL SECRET 
CABHAMN FREECOM SKULL 


the TapeList.TAP selected already. To bring the list of 


“an 


files on the screen, just type LOAD “”. 
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4. Joystick interfaces Sinclair 1, 2 and Kempston 





For game players the ZX-Tape interface is also supporting two Sinclair joystick inputs where the first one 
can be configured as Kempston. 


Interface Port 
Address * 


[Hex] 


=) 


Sinclair 1 When one of these port addresses is 


CONN3 accessed during keyboard scanning 


routine on ZX-Spectrum, the interface 
uses open collector output on the data 


Key — 0 on Pin6 
Key —9 on Pin1 


bus to fetch information about the 
joystick state. It simulates the pushing of 
Sinclair 2 


CONN2 


specific keys if the appropriate pin is set 
to logic Lo or the pin is grounded. 


Key —5 on Pin6 
Key —4 0n Pin1 


Kempston When this port address is accessed during 


CONN3 lO operation, the interface transfers 8 bits 


of data as a totem pole output on the 
data bus. Bits 6 and 7 are always set to 
logic Lo or ‘0’. The logic level Hi or ‘1’ is 
read if the appropriate pin is set to logic 


LEFT on Pin3 


Lo or if the pin is grounded. Otherwise if 


BUTTON2 on PINY 
RIGHT on Pin4 


BUTTON1 on PIN6 Key — 2 on Pin4 Key -—7onPin4 | == 
DOWN on Pin2 Key — 3 on Pin2 Key-8onPin2 |») 


the input pin is left open, the data bit 
reads logic Lo or ‘0’. 





* X-don’t care bits 


4.1 Configuration 
Joystick connector CONN3 can be configured by first of the DIP switches on the board to operate as: 
Sinclair1 when switch is in\OFF position or as Kempston when switch is in ON position. 
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To be compatible with joysticks or joypads from different manufacturers, pin 7 on both connectors 
CONN2 and CONN3 can be configured to supply +5 V from the ZX-Spectrum |\to the joystick’s circuitry. 
For example joysticks with an automatic fire button need active electronic parts inside to make it work. 
Set the third of the DIP switches on the board to ON position when +5 V is required. In OFF position the 
pin 7 on both connectors becomes passive. 





5. DEBUG assembler under Zilog Developer Studio 


When you start mastering BASIC programming you will soon realize that some routines are not as fast as 
you would expect. For example BASIC is not good at binary operations. When you look closely at the 
program in chapter 6.3, reading of bit O from the register takes 2 lines of BASIC code and it also looks a 
bit complicated. The same task when written in assembler requires only a few instructions. Also if you 
imagine that each BASIC command line consists of hundreds of assembler instructions, you will realize 
that the cost of easy interpretation of BASIC language reflects in its speed. 


To speed up their programs many programmers are combining BASIC with assembler routines or using 
pure assembler code. One of them is Matthew Smith who developed the famous game Manic Miner 
completely in assembler language. He reconnected his ZX spectrum via parallel cable with a TRS-80 PC 
from where he sent the assembler program directly to the memory of ZX spectrum for further 
debugging. 


The ZX-Tape interface in DBG mode is capable of doing the same thing. It sends assembler code 
compiled on your PC into memory of ZX spectrum and starts it there. 


Let’s assume you are using Zilog Developer Studio | version 3.68 downloaded from zilog.com as your 
assembler compiler, and ZX-Tape interface configured for DBG mode. Every time you successfully 
compile your assembler in the developer studio, you get a new binary (hex) file as an output. If you set 
the path of this file in ZXTape application, then the application will start checking the timestamp of the 
file. As soon as it changes, the application will reset ZX Spectrum and start loading new binary (hex) file 
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with your assembler program into memory of ZX Spectrum, continuing with its execution. This feature 


will help you learn to develop and debug your own assembler routines. See the following diagram: 


Has the *.bin/*.hex 
timestamp changed? 














Menu: Auto reset in 
1D) st CM aalele(=me) alg 


ZXTape App resets 


ZX Spectrum 
manual reset 


ZX Spectrum checks state 
of DBG switch. Is it on? 







Yes 


Skip over memory test 
elavem=>.(-Labja=mee)anlat-lace| 
oy:\ page| oy:4m WN aed 


dgb.TAP 






10 CLEAR 30000 





Obtain CODE with hex/bin , 7 
data from ZXTape App 0 20 LOAD dbg CODE 32768, 1024 





Execute assembler from 
pee =| 40 RANDOMIZE USR 32768 


* When the Auto reset in DBG mode is off, you must manually reset the ZX Spectrum to load assembler. This can be useful in case that your 


assembler is causing a reset of the machine and thus reloads itself in an infinite cycle. 


5.1 Example of dbg.TAP file for DEBUG mode 
After the installation of ZXTape application, this file is located in “C:\TAP\dbg.TAP”. It is loaded into ZX 


Spectrum after manual or automatic reset of the machine in DBG mode. Example of the code: 
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10 CLEAR 30000 

20 LOAD “dbg” CODE 32768, 1024 

30 CLS 


40 RANDOMIZE USR 32768 


If you want to combine assembler with BASIC, first you need to make sure that your assembler code will 
not interact with BASIC memory space. Using CLEAR 30000 on the first line sets the RAMTOP variable to 
memory address 30000. This RAMTOP variable is limiting working space for basic up to address 30000. 
After this command all memory space above this address will become available for use in your 
assembler program without interfering with BASIC and vice versa. 


The second line loads your assembler starting at address 32768 in Spectrum memory with a length of 
1024 bytes. If your assembler program is longer than 1024 or you wish to start your assembler code at a 
different address, then you must modify your dbg.TAP file. 


The next line clears the screen and then the last line executes your assembler at address 32768. 


In case you need to modify any of the parameters in dbg.TAP, use save command with LINE argument 
which will automatically start BASIC program dbg at line 10 after loading: 


SAVE “dbg” LINE 10 


Make sure your modified dbg.TAP file is in the TAP directory, and configuration of ZXTape application is 
correct before you start writing and debugging your own assembler. 


5.2 DEBUG mode configuration 


For correct configuration of the ZX-Tape interface for debugging you assembler code follow these steps: 


File § Settings Tools | File Settings 


LOAD file: Blue Tooth Com Por 
CATAPBooty1.TAP 

DBG file: 

C:\Zilog\Projects’, Test'test hex 


TAP Files Directory: 
C:\TAP 


Play ta-da on SAVE Auto reset in DBG 
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3. Open Zilog Developer Studio and create a testing assembler program called main.asm. See picture 
below. The program will write value 255 into the first line of the video memory from address 16384 to 
16388 and then it enters an infinite loop. It is important to write line: .ORG O8000h at the beginning of 
the assembler file. This will force the compiler to put the first instruction of your code at address O8000h 
in the binary file or more precisely in the ZX Spectrum memory. Remember that the ZXTape application 
is reading binary file from the offset you can set in File menu. After compilation, the Zilog Developer 
Studio will fill address soace between O0000h and O7FFFh with zeros in the file. After that it continues 
with program data. This is because the .ORG directive tells the compiler to place your code from address 
O8000h. This address must match first parameter of basic LOAD command in dbg.TAP file on line 20. See 
previous section 5.1. Furthermore, we also need to set DBG file offset in the File menu to 32768 
(O8000h). This will force ZXTape application to start reading the binary file from address (with an offset 
in the file) 32768 (O8000h), where the program’s data is located. Some other compilers like z88dk are 
creating binary files without filling zeros at the start of the file, but still expect that the program data will 
start at address 32768 (O8000h). In such case we must set the DBG file offset in the menu to O. Picture 
below shows the situation in our example: 


* bin file ZX Spectrum memory 


OFFFFh OFFFFh 
OFFFEh OFFFEh 
* * 





08001h 08001h 
retstoreye) First asm instruction 03000h 


O7FFFh O7FFFh 
O7FFEh O7FFEh 
* * 


DBG File 






offset : 


File reading direction 


* 
00001h 


00000h 00001h ROM 
00000h_| 





«Skipped data: | 


When it is all correctly set, hit the button to compile your assembler. If the Auto reset in DBG is 
selected, ZXTape application will automatically load your assembler into ZX Spectrum. Now, as a result, 
if you see a black horizontal line on the TV screen, your program has worked! 





ZiLOG Developer Studio - [main.asm] 
kA File Edit View Project Build Tools Window Help = &| x 
Oe st Be Se? |CRas lb FAR Con SHA Fo Fee K 
; =| x! 
= & C:\Zilog\Projects\Test\test.zws 
E) &y Source Files 


- main.asm LD HL, 016384 
LD (HL), OFFh 


-ORG 08000h 





START: 


s-~ yy Dependencies 
LD HL, 016385 
LD (HL), OFFh 


LD HL, 016386 
LD (HL), OFFh 


LD HL, 016387 
LD (HL), OFFh 


LD HL, 0163868 
LD (HL), OFFh 





x!/Deleting output files for project 
t\|Building... 
\||main.asm 
0 error(s). O warning(s) 
k eA 


Linking 





test.ld - 0 error(s), 0 warning(s) 


ae 
|| [44> DP Buita A Debug A Find \ OTP 


Ready Ee Ln et Col | =I | 
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6. Write your own spectrum programs with Bluetooth HC-05 





If your programming skills are improved and you are looking for something more advanced to 
experiment with, then you can look at the ZX-Tape interface. It provides simplified functionality of UART 
- universal asynchronous receiver-transmitter serial interface similar to TL16C550 circuit. Due to the 
limited number of macrocells in ATF1508 CPLD, this simplification was made by omission of handshaking 
signals which are not required for Bluetooth module HC-05 and by eliminating FIFO buffer. For more 
details about the register map, see the next chapter or check the schematics diagram at the end of this 
manual. 


6.1 Serial RS232 I/O Registers address space 
Register Port 
Name Address * 


[Dec] 


Receiver 37 IN/OUT 
& 
Transmitter 
Register 
RTR 
Line Status 
Register 
LSR 


6.2 Simple program in BASIC for transmitting data on RS232 


This program is transmitting ASCII character of the key pressed to the serial line. 


RTR - register is 8 bit wide. After write operation, data 
are transferred to the shift register and transmitted on 
TX pin at a baud rate of 115200. Check TE flag to ensure 
previous data was already transmitted before writing to 
this register. When the serial data is successfully 
received indicated by DR flag, use read operation on this 


= fa) N 
= = = 
co co co 
© © © 
~ ~ ~ 
© © © 
a) a) a) 


=i 

e fa 

co 

© 

~~ 

4°) 

Qa 

oc 

oc oc 
oc Lu 
Lu | 
a Zz 
= ao 
Lu 

7 > 
Oo 


Data Bit 7 
Data Bit 6 


register to fetch received data byte. 


DR —- data ready flag is set to 1 when RTR register 
received byte. Cleared after reading RTR_ register. 
OVERRUN_ERR — set when RITR register still contains 
previous data which hasn’t been read yet. FRAME_ERR 
— is set when invalid stop bit was received and cleared 
after LSR register was read. THRE — transmitter holding 
register empty flag and TE — transmitter empty flag are 
identical due to the limited resources. When set, the 
RTR register can accept new data to be transmitted, 
otherwise it is cleared. DBGSel flag is not part of the 
serial line concept. It monitors the position of the DBG 
switch on the board. 





un =) 
= = 
co co 
© © 
» 
© © 
a) Q 
Lud 
ce 
als 
- 


10 CLS 

20 LET kS = INKEYS 

30 IF kS="" THEN GO TO 20 

40 PRINT AT O, 0; k$ 

50 OUT 37, CODE k$ 

60 IF INKEYS<>"" THEN GO TO 60 
70 GOTO 20 


Note: In assembler, a similar program would run much faster, so checking TE bit would be essential. 
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6.3 Simple program in BASIC for receiving data on RS232 


This program is receiving ASCII characters from the serial line and displaying them on the screen. 


10 CLS 

20 LETs=IN55 

30 LET half = INT(s/2) 

40 IF (s-2*half) = O THEN GO TO 20 
50 PRINT AT O, 0; CHRS IN 37 

60 GO TO 20. 


Note1: We use a little trick here to identify Bit 0 - Data Ready of LSR register. Least significant bit says whether the number is odd or even. Line 
30 divides the value of status byte by 2 and assigns to variable half only the integer part of the number after division. On line 40 we check if 
there is a remainder. If so, Bit O was set and we continue in the program. 

Note2: Make sure that your serial terminal program on PC is transmitting characters immediately when the key is pressed. 


6.4 Is that all? 


No, you can go even further. Through special configuration the Bluetooth HC-05 module offers more 
options then its original use. The content of the ZX-Tape interface package includes a manual for HC-05. 
You can find information there about one of the interesting configurations of this module called Peer to 
Peer. If you have a friend with another ZX-Spectrum, you can use your Bluetooth modules in this 
configuration, so you will be able to exchange data between each other. Does it ring a bell? Well, 
imagine you can create games for 2 players like a ship battle! 
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8. Known issues in ZXTape application 
Software version 1.00: 


> When the power to ZX-Spectrum is interrupted the Bluetooth communication can be lost for a 
while. It can take 20 seconds before the ZXTape application recognizes this situation and 
displays: No Connection... When the power is back on, it will reconnect in 3 seconds. Please wait 
until the ZXTape application will establish connection again showing state: Ready... 


——E—E—E—— 
5/12/2020 | First release of this document. 
Small text 


ee ee Information added about supported Windows OS versions. 


corrections. 


9/1/2021 | Added information about DBG file offset in section 3.2.1 and corrected 
example in section 5.2 
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